home *** CD-ROM | disk | FTP | other *** search
/ STraTOS 1997 April & May / STraTOS 1 - 1997 April & May.iso / CD01 / INTERNET / SITES / KELLIS / KEMD.ZIP / KEMD / KGMD.TXT < prev    next >
Encoding:
Text File  |  1997-01-25  |  12.5 KB  |  294 lines
  1.              _   __  ________   ___    ___   ______
  2.             | | / / | |______| |   \  /   | |  ___ \
  3.             | |/ /  | |____    | |\ \/ /| | | |   | |
  4.             |   <   | |____|   | | \__/ | | | |   | |
  5.             | |\ \  | |______  | |      | | | |___| |
  6.             |_| \_\ |________| |_|      |_| |______/
  7.                  
  8.                      Knarf s German MiNT distribution
  9.  
  10.                            version 1.0-RELEASE
  11.  
  12.                               16. July 1995
  13.  
  14.                     Frank Bartels (knarf@nasim.cube.net)
  15.  
  16.                 (Big help from the French translation made by: 
  17.                  Lupin -Aout 1996
  18.                     contact: -Email: Thierry à jmpatat@asi.fr
  19.                              -Minitel: Lupin sur TEASER
  20.                                        Lupin69 sur RTEL)
  21.                     The translation is not perfect, but as close as 
  22.                     possible, and should be clear enough to get a 
  23.                     clean Mint environment.
  24.                             Just translated by K.Ellis (01/25/97)
  25.  
  26. In brief:
  27.  
  28. 0. Importante note
  29. 1. What is KGMD?
  30. 2. Why KGMD?
  31. 3. What do you need ?
  32. 4. What to do before starting the installation?
  33. 5. What you should do or maintain after the installation?.
  34. 6. Doing some modifications on the distribution.
  35.  
  36. 0. importante note
  37.  
  38.    If you want to install KGMD, you HAVE to read this WHOLE text
  39.    before doing anything.
  40.  
  41. 1. What is KGMD?
  42.  
  43.    KGMD is the german MINT distribution Knarf. With this
  44.    distribution, every Atari user should be able to install a clean 
  45.    Mint environment.
  46.    The multitasking will be as perfect as possible, and after the
  47.    installation everyone should feel their atari is just like a true 
  48.    Unix machine.
  49.    One of the rules for this distribution is:
  50.    No binary files without the corresponding source file.
  51.    For every binary file the diffs are available.
  52.    Everyone thus can reproduce the binary files. For some people 
  53.    this is not important ("under TOS I don't have the sources?"), 
  54.    other think it's important.
  55.  
  56.    The programs whose sources are not freely available are not in 
  57.    this distribution.
  58.  
  59. 2. why KGMD?
  60.  
  61.    KGMD has been created, because more and more users are 
  62.    interested in MINT, but the documentation is relatively poor
  63.    (Alle Speicher gespuelt(Novell),Alle Dateien nicht loeschen? N/J (MS-DOS),
  64.    Meinen Sie '='oder'=='? (SINIX C-Compiler), Kellerspeicher ueberflutet, ...).
  65.  
  66.    Through a weak documentation, alot of users failed the 
  67.    installation for this compiler. Without it, you can not work under 
  68.     MINT.
  69.    ???Es wird eben meistens davon ausgegangen, dass man sich bereits mit UNIX
  70.    beschaeftigt hat. Letzteres ist natuerlich auch bei dieser Distribution von grossem
  71.    Vorteil, aber es ist nicht Bedingung.???
  72.    Also, because of the numerous files needed for a complete 
  73.    installation, it's hard to keep a good global overview.
  74.    Only few anonymous FTPs put all the files for the interested 
  75.    users. The MailBoxes, most of the time, don't have the storage 
  76.    capacity for such amount of data.
  77.    Besides in most of the MailBoxes, the files are in the 8+3 format, 
  78.    which leads to losing some information.
  79.  
  80. 3. What do you need ?
  81.  
  82.    It's always hard to answer this question. Theorically,
  83.    MiNT should run on every atari computers.
  84.    Actually, to be able to work comfortably with KGMD, the following 
  85.    configuration is necessary:
  86.  
  87.    - 4 Mb Ram
  88.    - a free partition in your hard drive, which once KGMD installed, 
  89.      the room left should be at least 10Mb to work.
  90.      After installation, the different parts of the kit take the 
  91.      following room:
  92.  
  93.      - Basic   12 Mb (minimum required)
  94.      - Compiler 7 Mb
  95.      - Manual   6 Mb
  96.      - Net      4 Mb (minimum required)
  97.      - X11     14 Mb 
  98.  
  99.    The speed of your computer is very important too.
  100.    However, MINT is usable on a plain ST at 8MHz. Some people will 
  101.    notice the slowness for the compilation,
  102.    ???aber fast keine Anwendung verlaesst sich auf eine bestimmte
  103.    Rechnergeschwindigkeit. Lediglich die Ansteuerung der seriellen
  104.    Schnittstelle(n) birgt auf langsamen Rechnern Probleme.???
  105.  
  106. 4.  What to do before starting the installation?
  107.  
  108.    - Firstly, a big partition has to be free for the installation   
  109.      This partition must be a GEMDOS partition to work, so the 
  110.      letter of the corresponding drive should be accessible on the 
  111.      desktop.
  112.      While the installation, this partition will be converted in a    
  113.      Minix partition, that means, " ALL THE DATA ON THIS PARTITION 
  114.      WILL BE LOST"!!!
  115.  
  116.    - The individual packets of the distribution (basic, manual,
  117.      compiler, net et x11) will be copied in any directory in the 
  118.      hard drive. PLEASE write down the path, it will be asked further 
  119.      in the installation.
  120.      
  121.      These big archives are called something like basic.aa, basic.ab, 
  122.      etc..
  123.      They will automatically be reassembled while the installation.
  124.      For a minimal work, only the basic archive is necessary.
  125.      The installed packets will be the only ones present in the 
  126.      directory that you'll indicate. Thus, if you don't want some 
  127.      parts of the distribution, don't put them in the directory.
  128.  
  129.    - Copy the archive `instflpy.zoo'  on a blank floppy
  130.      If you don't have, yet, any bootdisk (minimint).
  131.      You can also copy this archive in a harddisk directory.
  132.      Double-check this partition of your Hard disk doesn't have any 
  133.      file called something like *.XDD in the directory     
  134.      `<drive>:\', `<drive>:\MINT\' et `<drive>:\MULTITOS!
  135.      Otherwise these drivers will be loaded while the installation   
  136.      and that could be very annoying for the installation process.
  137.  
  138.    - Start your computer again without any auto program or accessory.
  139.      Only the hard disk driver is necessary. A bootselector will be 
  140.      helpfull.
  141.  
  142.    - From the desktop, run KGMDINST.TOS of your boot floppydisk  
  143.      or from your installation directory, file created while the 
  144.      uncompress process of instflpy.zoo.  A dynamic Ramdisk is 
  145.      automatically created in which all the necessary files to the 
  146.      installation utilities will be copied.
  147.      All the installation is handled by the installation script, you 
  148.      only have to answer a few questions.
  149.  
  150.      Once the installation done, you'll be under a shell. From 
  151.      there you'll finnish the last part of the installation.
  152.  
  153.    - On the newly created Minix partition, a directory called  `boot' 
  154.      should be present. There are also 2 others directories called 
  155.      'auto' and 'multitos'.
  156.      In the directory `auto' there are 2 MINT programs:
  157.      `mint.prg` et `mint030.prg'.
  158.      Copy one of these 2 programs in your directory 'auto'.
  159.      If you use a FALCON or a TT, use 'MINT030.Prg' otherwise 
  160.      'MINT.Prg'.
  161.      Rename the auto prg MINT in the directory 'auto', for instance 
  162.      `mintkgmd.prg'. Like that it's more precise.
  163.  
  164.      Let's say you have a TT and the the `f' partition is the
  165.      Minix partition, Enter the following commands:
  166.  
  167.      # cd /f/boot/auto
  168.      # cp mint030.prg /c/auto/mintkgmd.prg
  169.  
  170.      Now, go into the `multitos' directory. From this directory you'll
  171.      copy `init.prg' program, the `minix.xfs driver and the 
  172.      configuration file `mintkgmd.cnf` in /usr/multitos (a symbolic
  173.      link on the Multitos directory for the boot drive).
  174.      The other files are not necessary yet.
  175.  
  176.      # cd /f/boot/multitos
  177.      # cp init.prg minix.xfs mintkgmd.cnf /usr/multitos
  178.  
  179.  
  180.      Double check there is no Mint directory on the boot drive 
  181.      (usually C:), as well as on the root of C: there is no such file 
  182.      like  'mint.cnf', '*.xfs' or '*.xdd'.
  183.  
  184.      You should install a boot selector (for instance: XBOOT, Stoop 
  185.      or superboot), make sure the boot selector is the first 
  186.      program in the auto folder ( "view unsorted" to see the real 
  187.      order. To set the order of the program execution there is 
  188.      AUTOSORT for instance) and now you can reboot.
  189.      Create a new configuration with the boot selector called for 
  190.      instance     'KGMD' .
  191.      Include the program `mintkgmd.prg'.
  192.  
  193.      I would also suggest you to include the program HSMODEM which 
  194.      must be run *BEFORE* Mint. All the auto programs are still 
  195.      there in this new configuration but are not used.
  196.      Make sure the file 'mintkgmd.cnf' has been copied under the name 
  197.      'mint.cnf'.
  198.  
  199.      If you don't use a boot selector, just copy the file 
  200.      `mintkgmd.cnf' in  /usr/multitos under the name 'mint.cnf':
  201.  
  202.      # cd /usr/multitos
  203.      # cp mintkgmd.cnf mint.cnf
  204.  
  205.      Activate, if necessary, HSMODEM in the auto folder:
  206.  
  207.      # cd /c/auto
  208.      # mv drvin.prx drvin.prg
  209.      # mv mfp.prx mfp.prg
  210.      # [etc...]
  211.  
  212.      You'll notice, in the AUTO folder, the programs physically placed
  213.      after `mintkgmd.prg' won't be loaded .
  214.      This feature is normal and wanted. The Falcon users who want to 
  215.      use BlowUp must rename 'Mintkgmd.prg' into 'mint.prg' or  
  216.      'mintnp.prg'.
  217.  
  218.      After the reboot, you shouldn't be worried if you see a 
  219.      description of the boot process followed by a Login-Prompt. 
  220.      Remember, at the end of the installation program, you typed for 
  221.      'root' and 'normal user' a password for both of them.
  222.      Browse a little bit in the directory tree, read the help 
  223.      file in /usr/src/KGMD and you'll learn about this new system.
  224.      Try some of the key-combinations ALT-F1 to ALT-F10 and take a 
  225.      look in the  /etc/ttytab directory.
  226.      Try to boot again to understand, after having read the files   
  227.      usr/multitos/mintkgmd.cnf and /etc/rc*.
  228.      Copy, if necessary, some new drivers from your 'boot' directory 
  229.      from your Minix partition to your boot-drive.
  230.      Take a closer look at the /etc/*.sample file and configure it 
  231.      for your local conditions( I guess your own environment?), 
  232.      especially the /etc/fstab file.
  233.  
  234. 5. What you should do or maintain after the installation.
  235.  
  236.    Here are few things to consider. Firstly, few wrong ideas will be 
  237.    corrected. Even if it's hard to accept them, they are simple.   
  238.  
  239.    - The GEM takes a lot of RAM (memory), processing time and the 
  240.      system is not really reliable. The GEM will only be launched 
  241.      when you need it.
  242.    - For Multitos, same remark.
  243.    - It's impossible to stop these 2 programs, meaning that after 
  244.      'GEM', you'll need to reboot.
  245.  
  246.    - The mouse will not be used. We'll learn that, with a text editor 
  247.       ???umzugehen??? which seems to be complicated, but later on 
  248.      will be very handy and fast after using it and get used to, 
  249.      until the point when you'll ask yourself:" how much could I sell 
  250.      my mouse?".
  251.  
  252.    - The drive letters and the backslashes (\) in the pathnames are 
  253.      absolutely taboo. You will only work on the drive U:
  254.  
  255.    - ???Abenteuerliche Konstrukte aus der DOSen Welt, wie etwa *.* sind
  256.      schlicht und ergreifend aus dem Gedaechtnis zu streichen.
  257.      Wildcards und Regular Expressions funktionieren nach Regeln,
  258.      nicht nach Mondstand. Merke: *.* passt auf READ.ME, nicht aber
  259.      auf README.???
  260.  
  261.    - For the end of lines we'll use LF instead of the Atari CRLF.
  262.  
  263.    - ???Der zu verwendende Zeichensatz ist ISO-8859-1. Die Virtuellen
  264.      Consolen stellen diesen Zeichensatz zur Verfuegung. Eine
  265.      Codierung nach irgendeiner aus der Luft gegriffenen,
  266.      modifizierten IBM Codepage ist nicht erwuenscht.???
  267.  
  268.    - In every case, the file compression will be a combination of 
  269.      'Detar' and  Gzip, these are the only good and safe 
  270.      possibilities to work with.
  271.      In extreme cases, you can also use ZOO, but the other packers
  272.      (like STZIP or LHARC) are totally unusable  
  273.  
  274.    - Work under 'ROOT' only if it's absolutely necessary.
  275.      Use `su' instead logging as root. Thus, you'll be very safe.
  276.  
  277. 6. Doing some modifications on the distribution:
  278.  
  279.   -  To install your own programs on the Minix Minix, use the 
  280.      tree directory /usr/local!
  281.  
  282.    - Only make changes on the installed files if you know EXACTLY 
  283.        what you are doing. WRITE DOWN all the changes you are making.
  284.  
  285.    - Write the configuration file changes under /etc.
  286.  
  287.    - If you follow these rules, you will not have any problems 
  288.      installing future versions. Do changes only in the /home
  289.      and /usr/local and only if necessary.
  290.      Few files under /etc and /var need to be saved, thus it will 
  291.      allow you to become accustomed for a future installation.
  292.  
  293.      ENJOY !!
  294.